﻿// ------------------------------------------------------------------------
// 项目名称：Canroc.Net 
// 版权归属：Canroc（https://gitee.com/canroc）
//
// 许可证信息
// Canroc.Net项目主要遵循 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-APACHE 文件。
//
// 使用条款：
// 1.使用本项目应遵守相关法律法规和许可证的要求。
// 2.不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动。
// 3.任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任
//
// 免责声明
// 对于因使用本代码而产生的任何直接、间接、偶然、特殊或后果性损害，我们不承担任何责任。
//
// 其他重要信息
// Canroc.Net 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。
// ------------------------------------------------------------------------

using Canroc.Net.RemoteHttp.WeChatPay.Dto;

namespace Canroc.Net.RemoteHttp.WeChatPay;

/// <summary>
///     微信远程请求
/// </summary>
[HttpClientName("wechat_pay")]
public interface IWeChatPayRemoteHttp : ICanrocRemoteHttpBase
{
    /// <summary>
    ///     微信支付下单
    /// </summary>
    /// <returns></returns>
    [Post("/v3/pay/transactions/jsapi")]
    Task<HttpRemoteResult<WeChatPayApiPlaceOutput>> PostPaymentPlaceAsync([Body] WeChatPayApiPlaceInput data);

    /// <summary>
    ///     微信支付关闭支付
    /// </summary>
    /// <returns></returns>
    [Post("/v3/pay/transactions/out-trade-no/{outTradeNo}/close")]
    Task<HttpResponseMessage> PostPaymentCloseAsync([Body] WeChatPayApiCloseInput data, string outTradeNo);

    /// <summary>
    ///     退款申请
    /// </summary>
    /// <returns></returns>
    [Post("/v3/refund/domestic/refunds")]
    Task<HttpRemoteResult<WeChatPayApiRefundOutput>>
        PostRefundApplicationAsync([Body] WeChatPayApiRefundInput data);

    /// <summary>
    ///     获取微信支付对账单
    /// </summary>
    /// <returns></returns>
    [Get("/v3/bill/tradebill")]
    Task<HttpRemoteResult<WeChatPayApiTradeBillOutput>> GetTradeBillAsync([Query] WeChatPayApiTradeBillInput data);

    /// <summary>
    ///     下载微信支付平台证书
    /// </summary>
    /// <returns></returns>
    [Get("/v3/certificates")]
    Task<HttpRemoteResult<WeChatPayApiCertificatesOutput>> GetCertificatesAsync();
}